package com.slmxz.tms.system.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.slmxz.tms.common.annotation.DataPermission;
import com.slmxz.tms.system.model.bo.UserBO;
import com.slmxz.tms.system.model.dto.UserAuthInfo;
import com.slmxz.tms.system.model.dto.UserExportDTO;
import com.slmxz.tms.system.model.entity.User;
import com.slmxz.tms.system.model.form.UserForm;
import com.slmxz.tms.system.model.query.UserPageQuery;
import com.slmxz.tms.system.model.vo.UserVO;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户持久层
 * @author sunyao
 * @Date 2024/10/25
 */
public interface UserMapper extends BaseMapper<User> {

    /**
     * 管理员获取在途订单分页数据
     * @param page 分页对象
     * @return
     */
    List<UserVO> selectPage(IPage<UserVO> page, @Param("user") UserVO user);

    /**
     * 获取用户表单详情
     *
     * @param userId 用户ID
     * @return
     */
    UserForm getUserFormData(Long userId);

    /**
     * 根据用户名获取认证信息
     *
     * @param username
     * @return
     */
    UserAuthInfo getUserAuthInfo(String username);

    /**
     * 获取导出用户列表
     *
     * @param queryParams
     * @return
     */
    @DataPermission(deptAlias = "u")
    List<UserExportDTO> listExportUsers(UserPageQuery queryParams);

    /**
     * 获取用户个人中心信息
     *
     * @param userId 用户ID
     * @return
     */
    UserBO getUserProfile(Long userId);
}
